ng-container-terminal
v0.7.13
Published
Container terminal related UI components & tools based on Angular & d3
Downloads
297
Readme
NgContainerTerminal
一套基于Angular和d3开发的集装箱码头相关的UI组件及工具。
UI组件
UI组件主要包含两个部分:场地UI组件、船舶UI组件。
场地UI组件
- 箱区分布图(初始版,待增强) ct-yard-overview
- 箱区详情图(初始版,待增强) ct-yard CtYardComponent
- 区位侧面图(初始版,待增强) ct-yard-bay
船舶UI组件
- 船舶分贝图(计划中,未开始) ct-vessel-bay
- 船舶侧面图(计划中,未开始) ct-vessel-side-view
- 箱量分布图(计划中,未开始) ct-vessel-container-stat-view
工具类
- 场地位置字符串位置解析服务(已完成) CtYardposParserService
- 船箱位字符串解析服务(计划中,未开始) CtVescellParserService
使用指南(Guides)
数据模拟服务 CtMockService
用于提供模拟数据测试UI组件效果
示例(Usage Example)
在module中引入该服务
import { AppComponent } from './app.component';
import { CtYardModule } from 'ng-container-terminal';
import { CtMockService } from 'ng-container-terminal/mock';
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
@NgModule({
declarations: [
AppComponent
],
imports: [
BrowserModule,
CtYardModule
],
providers: [ CtMockService ],
bootstrap: [ AppComponent ]
})
export class AppModule { }
在component中使用
import { Component, OnInit } from '@angular/core';
import { YardposInfo } from 'ng-container-terminal';
import { CtMockService } from 'ng-container-terminal/mock';
@Component({
selector: 'app-root',
templateUrl: './app.component.html',
styleUrls: ['./app.component.css']
})
export class AppComponent {
constructor(private mock: CtMockService) {
this.mock.getYardposInfoList().subscribe((blockLocations: YardposInfo[]) => {
this.blockLocations = blockLocations;
});
}
}
在html中使用绑定该模拟数据到CtYardCompoent的yardposInfoList上;
...
<ct-yard [yardposInfoList]="blockLocations"></ct-yard>
...
场地位置字符串位置解析服务 CtYardposParserService
场地位置字符串位通常由4部分构成(区、位、排、层), 如: *1A0010203。
用户可通过为服务配置pattern字符串,从而使得解析器能够根据pattern提取(区、位、排、层)。
示例(Usage Example)
在模块中引入该服务,并提供pattern
import { NgModule } from '@angular/core';
import { CommonModule } from '@angular/common';
import { CtYardComponent } from './ct-yard/ct-yard.component';
import { CtYardposParserService, YARDPOS_PARSER_CONFIG } from 'ng-container-terminal/tool';
@NgModule({
imports: [
CommonModule
],
declarations: [ CtYardComponent ],
exports: [ CtYardComponent ],
providers:[
[CtYardposParserService, {
provide: YARDPOS_PARSER_CONFIG, useValue: {pattern: 'QQQWWWPPCC'}
}]
]
})
export class CtYardModule { }
在组件中使用该服务
...
import { CtYardposParserService } from 'ng-container-terminal/tool';
@Component({
selector: 'ct-yard',
templateUrl: './ct-yard.component.html',
styleUrls: ['./ct-yard.component.css'],
changeDetection: ChangeDetectionStrategy.OnPush
})
export class CtYardComponent {
constructor(private yardposParser: CtYardposParserService) {
// 获取场地位置的排
this.yardposParser.getP('*1A0010203');
}
}