Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/qqilihq/property-editor
An editor for hierarchical properties as Java Swing component
https://github.com/qqilihq/property-editor
editor gui java property swing tree
Last synced: 3 months ago
JSON representation
An editor for hierarchical properties as Java Swing component
- Host: GitHub
- URL: https://github.com/qqilihq/property-editor
- Owner: qqilihq
- License: lgpl-3.0
- Created: 2017-04-17T13:37:48.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2021-11-13T21:44:00.000Z (about 3 years ago)
- Last Synced: 2024-10-10T04:07:37.341Z (3 months ago)
- Topics: editor, gui, java, property, swing, tree
- Language: Java
- Size: 1.9 MB
- Stars: 11
- Watchers: 4
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
Hierarchical Property List Editor
=================================
[](https://github.com/qqilihq/property-editor/actions)
[](https://codecov.io/gh/qqilihq/property-editor)
[](http://mvnrepository.com/artifact/de.philippkatz.swing.property/property-editor)
An editor for hierarchical properties as Java Swing component. Shamelessly
inspired by Apple's Property List Editor in Xcode. It allows building data
structures based on `Map`s and `List`s and primitive types such as `Long`,
`Double`, and `Boolean`. It is originally created for the [KNIME Selenium
Nodes][1] but it could probably be of general interest.
The editor is built on top of SwingX from [SwingLabs][3].
Download
--------
Via Maven:
```xml
de.philippkatz.swing.property
property-editor
2.0.1
```
Usage
-----
```java
// create a new component and pass the data
Object input = …
PropertiesTreeTableModel model = new PropertiesTreeTableModel(input);
PropertiesEditor editor = new PropertiesEditor(model);
// access to the data; this is either a Map or a List
Object result = model.getData();
```
Full Working Example
-----------------------
Have a look at `PropertiesEditorDemo` for a more detailed version.
```java
public class PropertiesEditorDemo {
private static Object createSampleData() {
Map root = new LinkedHashMap<>();
root.put("string", "The quick brown fox");
root.put("boolean", true);
root.put("numbers", 42);
root.put("fruits", Arrays.asList("apple", "orange", "grapefruit"));
return root;
}
public static void main(String[] args) {
JFrame frame = new JFrame();
frame.setTitle("Properties Editor Demo");
frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
frame.setMinimumSize(new Dimension(600, 400));
frame.add(new PropertiesEditor(new PropertiesTreeTableModel(createSampleData())));
frame.setVisible(true);
}
}
```
Advanced
--------
The types to use in the editor can be customized using the
`PropertiesEditorConfig`. It also allows to change the type names in the user
interface. Example:
```java
PropertiesEditorConfigBuilder configBuilder = PropertiesEditorConfig.builder();
// use "Object" and "Array" instead of "Map" and "List"
configBuilder.addType(new PropertyTypes.MapType("Object"));
configBuilder.addType(new PropertyTypes.ListType("Array"));
// only allow String and Boolean
configBuilder.addDefaultType(new PropertyTypes.StringType("String", ""));
configBuilder.addType(new PropertyTypes.BooleanType("Boolean", true));
PropertiesEditorConfig config = configBuilder.build();
PropertiesTreeTableModel model = new PropertiesTreeTableModel(config, data);
```
Contributing
------------
Pull requests are very welcome. Feel free to discuss bugs or new features by
opening a new [issue][2].
License
-------
[GNU Lesser General Public License](https://www.gnu.org/licenses/lgpl.txt)
- - -
Copyright (c) 2017 – 2020, Philipp Katz
[1]: http://seleniumnodes.com
[2]: https://github.com/qqilihq/property-editor/issues
[3]: https://en.wikipedia.org/wiki/SwingLabs