フロントエンド開発キットWijmoJS-カスタムDropDownTreeコントロールの作成(ソースコードを含む)
26713 ワード
概要
最近、お客様からフロントエンドのドロップダウンコントロールを開発するように要求されましたが、ユーザーが個別に選択できるプロジェクトコントロールが含まれているリストが表示され、ドロップダウンリストに複数選択のTreeView(ツリー)が表示されます.
WijmoJSでは、カスタムDropDownTreeコントロールとソースコードの作成方法について説明します.
DropDownTreeコントロールソースコード
HTML
JavaScript
コントロールの準備が完了すると、次のようになります.
このコントロールでは、2つの独立したWijmoJSモジュールを使用します.入力とナビゲーションです.必要な手順は、MultiSelectコントロールを開発するときに使用する手順と同じです.
ベースクラスの選択
このシナリオでは、ドロップダウンボタンを使用して入力要素を実装するために必要なすべての論理と、任意のコントロールを管理するために使用できる汎用ドロップダウンリストを含むDropDownコントロールを拡張できます.DropDownコントロールは、ComboBox、InputColor、およびInputDateコントロールのベースクラスとして使用されます.
オブジェクトモデルの定義
DropDownTreeコントロールはドロップダウンリストでTreeViewを管理しているため、DropDownTreeからTreeViewコントロールの主なプロパティを直接公開することにしました. TreeViewドロップダウンリストに表示されるTreeViewコントロールへの参照を取得します. ItemsSource TreeViewを埋め込むオブジェクト配列への参照を取得または設定します. DisplayMemberPathプロジェクトのビジュアル表示として使用される属性名を取得または設定します(デフォルトは「header」). ChildItemsPathは、データ・ソースの各アイテムを含むサブアイテムのプロパティの名前を取得または設定します(デフォルトは「items」). ShowCheckboxesは、コントロールが各アイテムにチェックボックスを追加すべきかどうかを決定する値を取得または設定し、ユーザーが複数のアイテム(デフォルトはtrue)を選択できるようにします.
また、現在の選択とコントロールヘッダでの表現を定義する追加のプロパティとイベントも追加しました.これらの属性は、MultiSelectコントロールの対応する属性をミラーします. CheckedItems現在選択されているアイテムを含む配列を取得または設定します. CheckedItems Changedは、CheckedItems属性値の変更時に発生するイベントです. MaxHeaderItemsは、コントロールヘッダに表示される最大選択項目数です. コントロールに*maxHeaderItemsを超える項目オプションがある場合、headerFormatはタイトルコンテンツを作成するためのフォーマット文字列を取得または設定します. HeaderFormatterは、コントロールヘッダに表示されるテキストを取得または設定する関数です.これにより、maxHeaderItemsおよびheaderFormatプロパティの設定が上書きされます.
インプリメンテーションコントロール
まず、コントロールをベースクラスの拡張として宣言します.
「extendsDropDown」文は、属性、イベント、メソッド、およびすべての内部/プライベートメンバーを含む基本的なDropDownクラスのすべての機能を継承するコントロールを保証します.
ツリービューの作成
次にDropDownクラスのcreateDropDownメソッドを使用して、ドロップダウンリストに表示されるTreeViewコントロールを作成します.
TreeViewの作成に加えて、onIsDroppedDownChangedメソッドを上書きして、ドロップダウンリストが開き、コントロールにフォーカスがある場合にツリーにフォーカスを移動します.これにより、ユーザーはキーボードナビゲーションツリーを使用できます.コンテンツを入力してアイテムを検索したり、スペースキーを押してアイテムをチェックしたり、カーソルキーを使用してツリーをナビゲートしたりすることができます.
TreeViewとそのプロパティの公開
次に、公開TreeViewとその主なプロパティを追加します.
これらのプロパティは、含まれるTreeView上の対応するプロパティのショートカットを取得または設定するだけです.そのため、TreeViewが処理するので、タイプチェックを有効にすることはできません.
CheckedItemsプロパティ
コントロールの主なプロパティはCheckedItemsで、ユーザーが現在取得およびカスタマイズしている配列を表します.上記のような伝達属性を実装したり、複数選択とラジオ機能を実装したりすることができます.たとえば、ラジオ機能を実装する場合は、ShowCheckboxesプロパティの値をチェックし、ツリーのcheckedItemsまたはselectedItemプロパティを使用する必要があります.
CheckedItems属性に加えて,checkedItemsChangedイベントとそれに伴う方法onCheckedItemsChangedも実現した.これはWijmoJSイベントの標準モードです.各イベントXには、イベントのトリガを担当する対応するonXメソッドがあります.
単一の選択の場合でも、checkedItemsプロパティは配列を返します(この配列は空または単一の要素が含まれています).
コントロールヘッダの更新
ここではmaxHeaderItems,headerFormatまたはheaderFormatterプロパティの実装方法については重点的に議論しません.簡単だからです.私たちは目を合わせる必要があります.updateHeader関数の論理では、これらの属性を使用し、値または変更を選択したときに自動的に呼び出してコントロールヘッダを更新します.
コンストラクタ
ここまで、コントロールアーキテクチャはほぼ完了しています.最後のステップは、コンポーネントをイベントリスナーに接続し、optionsパラメータのユーザーが提供する値を使用してプロパティとイベントハンドラを初期化するためにinitializeメソッドを呼び出すコンストラクション関数を実装することです.
テストコントロール
コントロールが準備されているので、テストして、目的の方法で実行されているかどうかを確認できます.
DropDownTreeコントロールのソースコードを実行し、ドロップダウンボタンをクリックしてTreeViewを開きます.開いたら、いくつかのアイテムをクリックして選択し、コントロールヘッダの更新方法に注意します.
DropDownsTreeコントロールがお役に立てることを心から願っています.さらに重要なのは、DropDownコントロールを他のタイプの要素を管理しながら、独自のカスタムコントロールを作成するために安心して拡張できることです.
WijmoJS:柔軟で効率的なフロントエンド開発ツールパッケージで、企業Webアプリケーションを迅速に構築できる
最近、お客様からフロントエンドのドロップダウンコントロールを開発するように要求されましたが、ユーザーが個別に選択できるプロジェクトコントロールが含まれているリストが表示され、ドロップダウンリストに複数選択のTreeView(ツリー)が表示されます.
WijmoJSでは、カスタムDropDownTreeコントロールとソースコードの作成方法について説明します.
DropDownTreeコントロールソースコード
HTML
DropDownTree Control
The DropDownTree control is similar to a
MultiSelect, but it hosts a TreeView
in the drop-down instead of a ListBox.
The DropDownTree's object model is also
similar to the MultiSelect's: you can listen
to the checkedItemsChanged event and get/set
the selection using the checkedItems property:
Drop-Down-Tree
Multi-Select
JavaScript
onload = function() { // create the DropDownTree var ddTree = new wijmo.input.DropDownTree('#ddTree', { displayMemberPath: 'header', childItemsPath: 'items', showCheckboxes: true, itemsSource: getTreeData(), checkedItemsChanged: function (s, e) { console.log('dropDownTree.checkedItemsChanged:'); s.checkedItems.forEach(function (item, index) { console.log(index, item[s.displayMemberPath]) }) } }); // create the MultiSelect var multiSelect = new wijmo.input.MultiSelect('#multiSelect', { itemsSource: 'Austria,Belgium,Chile,Denmark'.split(','), checkedItemsChanged: function (s, e) { console.log('multiSelect.checkedItemsChanged:'); s.checkedItems.forEach(function (item, index) { console.log(index, item) }) } }); // get the tree data function getTreeData() { return [ { header: 'Electronics', img: 'resources/electronics.png', items: [ { header: 'Trimmers/Shavers' }, { header: 'Tablets' }, { header: 'Phones', img: 'resources/phones.png', items: [ { header: 'Apple' }, { header: 'Motorola', newItem: true }, { header: 'Nokia' }, { header: 'Samsung' } ]}, { header: 'Speakers', newItem: true }, { header: 'Monitors' } ]}, { header: 'Toys', img: 'resources/toys.png', items: [ { header: 'Shopkins' }, { header: 'Train Sets' }, { header: 'Science Kit', newItem: true }, { header: 'Play-Doh' }, { header: 'Crayola' } ]}, { header: 'Home', img: 'resources/home.png', items: [ { header: 'Coffeee Maker' }, { header: 'Breadmaker', newItem: true }, { header: 'Solar Panel', newItem: true }, { header: 'Work Table' }, { header: 'Propane Grill' } ]} ]; } } // DropDownTree: transpiled TypeScript var __extends = (this && this.__extends) || (function () { var extendStatics = Object.setPrototypeOf || ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) || function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; }; return function (d, b) { extendStatics(d, b); function __() { this.constructor = d; } d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __()); }; })(); var wijmo; (function (wijmo) { var input; (function (input) { var DropDownTree = /** @class */ (function (_super) { __extends(DropDownTree, _super); /** * Initializes a new instance of the @see:DropDownTree class. * * @param element The DOM element that hosts the control, or a CSS selector for the host element (e.g. '#theCtrl'). * @param options The JavaScript object containing initialization data for the control. */ function DropDownTree(element, options) { var _this = _super.call(this, element) || this; _this._maxHdrItems = 2; _this._hdrFmt = wijmo.culture.MultiSelect.itemsSelected; /** * Occurs when the value of the @see:checkedItems property changes. */ _this.checkedItemsChanged = new wijmo.Event(); wijmo.addClass(_this.hostElement, 'wj-dropdowntree'); // make header element read-only _this._tbx.readOnly = true; // toggle drop-down when clicking on the header element // (and not on a containing label element) _this.addEventListener(_this.inputElement, 'click', function (e) { if (document.elementFromPoint(e.clientX, e.clientY) == _this.inputElement) { _this.isDroppedDown = !_this.isDroppedDown; } }); // update header now, when the itemsSource changes, and when items are selected _this._updateHeader(); var tree = _this._tree; tree.checkedItemsChanged.addHandler(function () { _this._updateHeader(); _this.onCheckedItemsChanged(); }); tree.selectedItemChanged.addHandler(function () { if (!tree.showCheckboxes) { _this._updateHeader(); _this.onCheckedItemsChanged(); } }); tree.loadedItems.addHandler(function () { _this._updateHeader(); }); // close tree on enter/escape tree.addEventListener(tree.hostElement, 'keydown', function (e) { switch (e.keyCode) { case wijmo.Key.Enter: case wijmo.Key.Escape: _this.isDroppedDown = false; break; } }); // initialize control options _this.initialize(options); return _this; } Object.defineProperty(DropDownTree.prototype, "treeView", { /** * Gets the @see:TreeView control shown in the drop-down. */ get: function () { return this._tree; }, enumerable: true, configurable: true }); Object.defineProperty(DropDownTree.prototype, "itemsSource", { /** * Gets or sets the array that contains the @see:TreeView items. * * @see:TreeView #see:itemsSource arrays usually have a hierarchical * structure with items that contain child items. There is no fixed * limit to the depth of the items. * * For details, see the @see:TreeView.itemsSource property. */ get: function () { return this._tree.itemsSource; }, set: function (value) { this._tree.itemsSource = value; }, enumerable: true, configurable: true }); Object.defineProperty(DropDownTree.prototype, "displayMemberPath", { /** * Gets or sets the name of the property (or properties) to use as * the visual representation of the nodes. * * The default value for this property is the string 'header'. * * For details, see the @see:TreeView.displayMemberPath property. */ get: function () { return this._tree.displayMemberPath; }, set: function (value) { this._tree.displayMemberPath = value; }, enumerable: true, configurable: true }); Object.defineProperty(DropDownTree.prototype, "childItemsPath", { /** * Gets or sets the name of the property (or properties) that contains * the child items for each node. * * The default value for this property is the string 'items'. * * For details, see the @see:TreeView.childItemsPath property. */ get: function () { return this._tree.childItemsPath; }, set: function (value) { this._tree.childItemsPath = value; }, enumerable: true, configurable: true }); Object.defineProperty(DropDownTree.prototype, "showCheckboxes", { /** * Gets or sets a value that determines whether the @see:TreeView should * add checkboxes to nodes and manage their state. * * For details, see the @see:TreeView.showCheckboxes property. */ get: function () { return this._tree.showCheckboxes; }, set: function (value) { this._tree.showCheckboxes = value; }, enumerable: true, configurable: true }); Object.defineProperty(DropDownTree.prototype, "checkedItems", { /** * Gets or sets an array containing the items that are currently checked. */ get: function () { var tree = this._tree; if (tree.showCheckboxes) { return tree.checkedItems; } else { return tree.selectedItem ? [tree.selectedItem] : []; } }, set: function (value) { var tree = this._tree; if (tree.showCheckboxes) { tree.checkedItems = wijmo.asArray(value); } else { tree.selectedItem = wijmo.isArray(value) ? value[0] : value; } }, enumerable: true, configurable: true }); Object.defineProperty(DropDownTree.prototype, "maxHeaderItems", { /** * Gets or sets the maximum number of items to display on the control header. * * If no items are selected, the header displays the text specified by the * @see:placeholder property. * * If the number of selected items is smaller than or equal to the value of the * @see:maxHeaderItems property, the selected items are shown in the header. * * If the number of selected items is greater than @see:maxHeaderItems, the * header displays the selected item count instead. */ get: function () { return this._maxHdrItems; }, set: function (value) { if (this._maxHdrItems != value) { this._maxHdrItems = wijmo.asNumber(value); this._updateHeader(); } }, enumerable: true, configurable: true }); Object.defineProperty(DropDownTree.prototype, "headerFormat", { /** * Gets or sets the format string used to create the header content * when the control has more than @see:maxHeaderItems items checked. * * The format string may contain the '{count}' replacement string * which gets replaced with the number of items currently checked. * The default value for this property in the English culture is * '{count:n0} items selected'. */ get: function () { return this._hdrFmt; }, set: function (value) { if (value != this._hdrFmt) { this._hdrFmt = wijmo.asString(value); this._updateHeader(); } }, enumerable: true, configurable: true }); Object.defineProperty(DropDownTree.prototype, "headerFormatter", { /** * Gets or sets a function that gets the HTML in the control header. * * By default, the control header content is determined based on the * @see:placeholder, @see:maxHeaderItems, and on the current selection. * * You may customize the header content by specifying a function that * returns a custom string based on whatever criteria your application * requires. */ get: function () { return this._hdrFormatter; }, set: function (value) { if (value != this._hdrFormatter) { this._hdrFormatter = wijmo.asFunction(value); this._updateHeader(); } }, enumerable: true, configurable: true }); /** * Raises the @see:checkedItemsChanged event. */ DropDownTree.prototype.onCheckedItemsChanged = function (e) { this.checkedItemsChanged.raise(this, e); }; //** overrides // switch focus to the tree when the drop-down opens DropDownTree.prototype.onIsDroppedDownChanged = function (e) { if (this.containsFocus() && this.isDroppedDown) { this._tree.focus(); } _super.prototype.onIsDroppedDownChanged.call(this, e); }; // create the drop-down element DropDownTree.prototype._createDropDown = function () { // create child TreeView control var lbHost = wijmo.createElement('
', this._dropDown); this._tree = new wijmo.nav.TreeView(lbHost, { showCheckboxes: true, }); // let base class do its thing _super.prototype._createDropDown.call(this); }; Object.defineProperty(DropDownTree.prototype, "isReadOnly", { // override since our input is always read-only get: function () { return this._readOnly; }, set: function (value) { this._readOnly = wijmo.asBoolean(value); wijmo.toggleClass(this.hostElement, 'wj-state-readonly', this.isReadOnly); }, enumerable: true, configurable: true }); // update header when refreshing DropDownTree.prototype.refresh = function (fullUpdate) { if (fullUpdate === void 0) { fullUpdate = true; } _super.prototype.refresh.call(this, fullUpdate); this._updateHeader(); }; //** implementation // update the value of the control header DropDownTree.prototype._updateHeader = function () { // get selected items var items = this.checkedItems; // update the header if (wijmo.isFunction(this._hdrFormatter)) { this.inputElement.value = this._hdrFormatter(); } else { var hdr = ''; if (items.length > 0) { if (items.length <= this._maxHdrItems) { if (this.displayMemberPath) { var binding_1 = new wijmo.Binding(this.displayMemberPath); items = items.map(function (item) { return binding_1.getValue(item); }); } hdr = items.join(', '); } else { hdr = wijmo.format(this.headerFormat, { count: items.length }); } } this.inputElement.value = hdr; } // update wj-state attributes this._updateState(); }; return DropDownTree; }(input.DropDown)); input.DropDownTree = DropDownTree; })(input = wijmo.input || (wijmo.input = {})); })(wijmo || (wijmo = {})); //# sourceMappingURL=DropDownTree.js.map
CSS
body {
margin-bottom: 24pt;
}
コントロールの準備が完了すると、次のようになります.
このコントロールでは、2つの独立したWijmoJSモジュールを使用します.入力とナビゲーションです.必要な手順は、MultiSelectコントロールを開発するときに使用する手順と同じです.
ベースクラスの選択
このシナリオでは、ドロップダウンボタンを使用して入力要素を実装するために必要なすべての論理と、任意のコントロールを管理するために使用できる汎用ドロップダウンリストを含むDropDownコントロールを拡張できます.DropDownコントロールは、ComboBox、InputColor、およびInputDateコントロールのベースクラスとして使用されます.
オブジェクトモデルの定義
DropDownTreeコントロールはドロップダウンリストでTreeViewを管理しているため、DropDownTreeからTreeViewコントロールの主なプロパティを直接公開することにしました.
また、現在の選択とコントロールヘッダでの表現を定義する追加のプロパティとイベントも追加しました.これらの属性は、MultiSelectコントロールの対応する属性をミラーします.
インプリメンテーションコントロール
まず、コントロールをベースクラスの拡張として宣言します.
namespace wijmo.input {
export class DropDownTree extends DropDown {
}
}
「extendsDropDown」文は、属性、イベント、メソッド、およびすべての内部/プライベートメンバーを含む基本的なDropDownクラスのすべての機能を継承するコントロールを保証します.
ツリービューの作成
次にDropDownクラスのcreateDropDownメソッドを使用して、ドロップダウンリストに表示されるTreeViewコントロールを作成します.
TreeViewの作成に加えて、onIsDroppedDownChangedメソッドを上書きして、ドロップダウンリストが開き、コントロールにフォーカスがある場合にツリーにフォーカスを移動します.これにより、ユーザーはキーボードナビゲーションツリーを使用できます.コンテンツを入力してアイテムを検索したり、スペースキーを押してアイテムをチェックしたり、カーソルキーを使用してツリーをナビゲートしたりすることができます.
namespace wijmo.input {
export class DropDownTree extends DropDown {
private _tree: wijmo.nav.TreeView;
// create the drop-down element
protected _createDropDown() {
// create child TreeView control
let lbHost = document.createElement('div');
setCss(lbHost, {
width: '100%',
border: 'none'
});
this._tree = new wijmo.nav.TreeView(lbHost, {
showCheckboxes: true
});
}
// switch focus to the tree when the drop-down opens
onIsDroppedDownChanged(e?: EventArgs) {
if (this.containsFocus() && this.isDroppedDown) {
this._tree.focus();
}
super.onIsDroppedDownChanged(e);
}
}
}
TreeViewとそのプロパティの公開
次に、公開TreeViewとその主なプロパティを追加します.
namespace wijmo.input {
export class DropDownTree extends DropDown {
private _tree: wijmo.nav.TreeView;
get treeView(): wijmo.nav.TreeView {
return this._tree;
}
get itemsSource(): any[] {
return this._tree.itemsSource;
}
set itemsSource(value: any[]) {
this._tree.itemsSource = value;
}
// same for displayMemberPath, childItemsPath,
// and showCheckboxes
// create the drop-down element
protected _createDropDown() {…}
}
}
これらのプロパティは、含まれるTreeView上の対応するプロパティのショートカットを取得または設定するだけです.そのため、TreeViewが処理するので、タイプチェックを有効にすることはできません.
CheckedItemsプロパティ
コントロールの主なプロパティはCheckedItemsで、ユーザーが現在取得およびカスタマイズしている配列を表します.上記のような伝達属性を実装したり、複数選択とラジオ機能を実装したりすることができます.たとえば、ラジオ機能を実装する場合は、ShowCheckboxesプロパティの値をチェックし、ツリーのcheckedItemsまたはselectedItemプロパティを使用する必要があります.
CheckedItems属性に加えて,checkedItemsChangedイベントとそれに伴う方法onCheckedItemsChangedも実現した.これはWijmoJSイベントの標準モードです.各イベントXには、イベントのトリガを担当する対応するonXメソッドがあります.
namespace wijmo.input {
export class DropDownTree extends DropDown {
private _tree: wijmo.nav.TreeView;
// TreeView pass-through properties…
get checkedItems(): any[] {
let tree = this._tree;
if (tree.showCheckboxes) {
return tree.checkedItems;
} else {
return tree.selectedItem
? [tree.selectedItem] : [];
}
}
set checkedItems(value: any[]) {
let tree = this._tree;
if (tree.showCheckboxes) {
tree.checkedItems = asArray(value);
} else {
tree.selectedItem = isArray(value)
? value[0] : value;
}
}
readonly checkedItemsChanged = new Event();
onCheckedItemsChanged(e?: EventArgs) {
this.checkedItemsChanged.raise(this, e);
}
// create the drop-down element
protected _createDropDown() {…}
}
単一の選択の場合でも、checkedItemsプロパティは配列を返します(この配列は空または単一の要素が含まれています).
コントロールヘッダの更新
ここではmaxHeaderItems,headerFormatまたはheaderFormatterプロパティの実装方法については重点的に議論しません.簡単だからです.私たちは目を合わせる必要があります.updateHeader関数の論理では、これらの属性を使用し、値または変更を選択したときに自動的に呼び出してコントロールヘッダを更新します.
namespace wijmo.input {
export class DropDownTree extends DropDown {
private _tree: wijmo.nav.TreeView;
// TreeView pass-through properties…
// checketItems property…
private _updateHeader() {
let items = this.checkedItems;
if (isFunction(this._hdrFormatter)) {
this.inputElement.value = this._hdrFormatter();
} else {
let hdr = '';
if (items.length > 0) {
if (items.length <= this._maxHdrItems) {
if (this.displayMemberPath) {
let dmp = this.displayMemberPath,
binding = new Binding(dmp);
items = items.map((item) => {
return binding.getValue(item);
});
}
hdr = items.join(', ');
} else {
hdr = format(this.headerFormat, {
count: items.length
});
}
}
this.inputElement.value = hdr;
}
}
// create the drop-down element
protected _createDropDown() {…}
}
}
コンストラクタ
ここまで、コントロールアーキテクチャはほぼ完了しています.最後のステップは、コンポーネントをイベントリスナーに接続し、optionsパラメータのユーザーが提供する値を使用してプロパティとイベントハンドラを初期化するためにinitializeメソッドを呼び出すコンストラクション関数を実装することです.
namespace wijmo.input {
export class DropDownTree extends DropDown {
private _tree: wijmo.nav.TreeView;
private _readOnly: boolean;
private _maxHdrItems = 2;
private _hdrFmt = wijmo.culture.MultiSelect.itemsSelected;
private _hdrFormatter: Function;
constructor(element: HTMLElement, options?: any) {
super(element);
addClass(this.hostElement, 'wj-dropdowntree');
// make header element read-only
this._tbx.readOnly = true;
// update header now, when the itemsSource changes,
// and when items are selected
this._updateHeader();
let tree = this._tree;
tree.checkedItemsChanged.addHandler(() => {
this._updateHeader();
this.onCheckedItemsChanged();
});
tree.selectedItemChanged.addHandler(() => {
if (!tree.showCheckboxes) {
this._updateHeader();
this.onCheckedItemsChanged();
}
});
tree.loadedItems.addHandler(() => {
this._updateHeader();
});
// initialize control options
this.initialize(options);
}
// TreeView pass-through properties…
// checketItems property…
// _updateHeader implementation…
// _createDropDown implementation…
}
}
テストコントロール
コントロールが準備されているので、テストして、目的の方法で実行されているかどうかを確認できます.
DropDownTreeコントロールのソースコードを実行し、ドロップダウンボタンをクリックしてTreeViewを開きます.開いたら、いくつかのアイテムをクリックして選択し、コントロールヘッダの更新方法に注意します.
DropDownsTreeコントロールがお役に立てることを心から願っています.さらに重要なのは、DropDownコントロールを他のタイプの要素を管理しながら、独自のカスタムコントロールを作成するために安心して拡張できることです.
WijmoJS:柔軟で効率的なフロントエンド開発ツールパッケージで、企業Webアプリケーションを迅速に構築できる