Neglected Pulse Machine

    @nextcloud/vue

    7.5.0 • Public • Published

    Vue components

    npm last version Dependabot status

    This repo contains the various Vue.js components that Nextcloud uses for its internal design and structure. It provides standardized UI elements for building Nextcloud app frontends with Vue.js.

    Documentation

    A list of available components with examples to try out is available in the documentation.

    Getting started

    App example

    If you want to check a real live example of a nextcloud app that uses this library, you can head over to https://github.com/skjnldsv/vueexample/ We will try to maintain this repository the best we can, but some example might be obsolete. Always check this repository documentation.

    Install the library

    npm i --save @nextcloud/vue

    Usage

    To use a component, just import it:

    import { NcAppNavigation, NcActions, NcActionButton } from '@nextcloud/vue'

    Registering all components.

    Be careful, this will registry all components, even the ones not being used.

    import Vue from 'vue'
    import NcComponents from '@nextcloud/vue/dist/install.js'
    
    Vue.use(NcComponents)

    Development setup

    If you want to work on improving the components it’s best to run the latest code and link it to your local Nextcloud installation:

    1. Install the dependencies with npm ci
    2. Build the components every time you do changes: npm run build or npm run build:module (for es modules)
      • To watch for changes and rebuild automatically: npm run watch or npm run watch:module
    3. Connect it to your local Nextcloud development setup:
      • In this repository do npm link
      • In the repository of an app do npm link @nextcloud/vue (you need to re-link any time you do npm ci in the app)
    4. Then build the app with: npm run build (or watch for changes with npm run watch)

    Styleguide

    When developing new components or extending compnents, make sure to also have some bits of related documentation like examples, where applicable. To test components and the documentation in that context, you can run npm run styleguide to run a local server that serves the style guide with all the components.

    Using vue-devtools in Firefox

    If you want to use vue-devtools in Firefox, you need to patch your nextcloud instance as follow:

    diff --git a/lib/public/AppFramework/Http/ContentSecurityPolicy.php b/lib/public/AppFramework/Http/ContentSecurityPolicy.php
    index 0e3a6a705d..416b8b0fb9 100644
    --- a/lib/public/AppFramework/Http/ContentSecurityPolicy.php
    +++ b/lib/public/AppFramework/Http/ContentSecurityPolicy.php
    @@ -41,9 +41,9 @@ namespace OCP\AppFramework\Http;
      */
     class ContentSecurityPolicy extends EmptyContentSecurityPolicy {
            /** @var bool Whether inline JS snippets are allowed */
    -       protected $inlineScriptAllowed = false;
    +       protected $inlineScriptAllowed = true;
            /** @var bool Whether eval in JS scripts is allowed */
    -       protected $evalScriptAllowed = false;
    +       protected $evalScriptAllowed = true;
            /** @var bool Whether strict-dynamic should be set */
            protected $strictDynamicAllowed = false;
            /** @var array Domains from which scripts can get loaded */

    Releasing a new version

    • Pull the latest changes from master or stableX;
    • Checkout a new branch with the tag name (e.g v4.0.1): git checkout -b v<version>;
    • Run npm version patch --no-git-tag-version (npm version minor --no-git-tag-version if minor). This will return a new version name, make sure it matches what you expect;
    • Commit, push and create PR;
    • Add the change log content from the 'Changelog' action on Github to CHANGELOG.md;
    • Commit and push;
    • Get your PR reviewed and merged;
    • Create a milestone with the follow up version at https://github.com/nextcloud/nextcloud-vue/milestones
    • Move all open tickets and PRs to the follow up
    • Close the milestone of the version you release
    • Create a release on github with the version as tag (e.g v4.0.1) and add the changelog content as description (https://github.com/nextcloud/nextcloud-vue/releases); image

    Releasing a pre-release

    A pre-release can be built in the same way as described above, however it requires manual adjustments to avoid that npm ships the pre-release to all users:

    1. Retag latest to the last stable release

      npm dist-tag add @nextcloud/vue@5.4.0 latest

    2. Tag the new pre-release as next

      npm dist-tag add @nextcloud/vue@6.0.0-beta.2 next

    Install

    npm i @nextcloud/vue

    DownloadsWeekly Downloads

    14,668

    Version

    7.5.0

    License

    AGPL-3.0

    Unpacked Size

    26.6 MB

    Total Files

    251

    Last publish

    Collaborators

    • pytal
    • gretadoci
    • mejo-
    • artonge
    • max-nextcloud
    • st3iny
    • marcoambrosinii
    • icewind1991
    • skjnldsv
    • christophwurst
    • juliushaertl
    • nickvergessen