Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/box/box-ui-elements
React Components for Box's Design System and Pluggable Components
https://github.com/box/box-ui-elements
box-api box-content-explorer box-content-open-with box-content-picker box-content-preview box-content-uploader box-platform box-preview javascript react
Last synced: 5 days ago
JSON representation
React Components for Box's Design System and Pluggable Components
- Host: GitHub
- URL: https://github.com/box/box-ui-elements
- Owner: box
- License: other
- Created: 2017-06-29T05:49:51.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-04-12T01:30:26.000Z (9 months ago)
- Last Synced: 2024-04-14T09:06:46.505Z (8 months ago)
- Topics: box-api, box-content-explorer, box-content-open-with, box-content-picker, box-content-preview, box-content-uploader, box-platform, box-preview, javascript, react
- Language: JavaScript
- Homepage: https://developer.box.com/docs/box-ui-elements
- Size: 69.8 MB
- Stars: 530
- Watchers: 68
- Forks: 289
- Open Issues: 99
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
[](http://opensource.box.com/badges)
[](https://circleci.com/gh/box/box-ui-elements/tree/master)
[](https://github.com/prettier/prettier)
[](https://mergify.io)
[](https://github.com/semantic-release/semantic-release)
# [Box UI Elements](https://developer.box.com/docs/box-ui-elements)
Box UI Elements are pre-built UI components that allow developers to add features of the main Box web application into their own applications. Use Box UI Elements to navigate through, upload, preview, and select content stored on Box. Box UI Elements are available as React components and framework-agnostic JavaScript libraries.
# [Demo](https://opensource.box.com/box-ui-elements/)
*Please note that the demo page has limited functionality.*
## Installation
`yarn add box-ui-elements` or `npm install box-ui-elements`
To prevent library duplication, the UI Elements require certain peer dependencies to be installed manually. For a list of required peer dependencies, see [package.json](package.json).
# Usage
This documentation describes how to use UI Elements in a [React](https://facebook.github.io/react) application using [webpack](https://webpack.js.org/). If instead you require a framework-agnostic solution, please refer to our [developer documentation](https://developer.box.com/docs/box-ui-elements). You can also reference our [Elements Demo App](https://github.com/box/box-ui-elements-demo) and [Preview Demo App](https://github.com/box/box-content-preview-demo) for examples of minimal React applications using ContentExplorer and ContentPreview, respectively.
### Common
- [Authentication](src/elements/README.md#authentication)
- [Internationalization (i18n)](src/elements/README.md#internationalization)
### Elements
- [ContentExplorer](src/elements/content-explorer/README.md)
- [ContentOpenWith](src/elements/content-open-with/README.md)
- [ContentPicker](src/elements/content-picker/README.md)
- [ContentPreview](src/elements/content-preview/README.md)\*
- [ContentSidebar](src/elements/content-sidebar/README.md)\*
- [ContentUploader](src/elements/content-uploader/README.md)
\* _These components utilize code splitting. See the [Code Splitting](#code-splitting) section for more information._
### Code Splitting
[Code splitting](https://webpack.js.org/guides/code-splitting/) is currently supported for some UI Elements. In order to use an Element with code splitting, you need to set it up in webpack.
### Stylesheets
Box UI Elements use [SCSS stylesheets](https://sass-lang.com/guide). Each of the Elements include their corresponding SCSS stylesheet to render properly. Once you `import` an Element within your React app, the corresponding stylesheet will automatically get included. However, you will need to [setup webpack](https://github.com/webpack-contrib/mini-css-extract-plugin#minimal-example) to handle `.scss` files by using the sass-loader / css-loader. This will direct webpack to properly include our SCSS files in your final CSS output. A sample configuration is [shown here](https://github.com/box/box-ui-elements-demo/blob/master/webpack.config.js) under the rules section.
### Browser Support
- Desktop Chrome, Firefox, Safari, Edge (latest 2 versions)
- Mobile Chrome and Safari
# Contributing
Our contributing guidelines can be found in [CONTRIBUTING.md](CONTRIBUTING.md). The development setup instructions can be found in [DEVELOPING.md](DEVELOPING.md).
# Questions
If you have any questions, please visit our [developer forum](https://community.box.com/t5/Box-Developer-Forum/bd-p/DeveloperForum) or contact us via one of our [available support channels](https://community.box.com/t5/Community/ct-p/English).
# Copyright and License
Copyright 2016-present Box, Inc. All Rights Reserved.
Licensed under the Box Software License Agreement v.20170516.
You may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://developer.box.com/docs/box-sdk-license
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.